Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

Java requirements

Many OpenEdge products require the Java Runtime Environment (JRE), the Java Development Kit (JDK), or both of these components to use specific product functionality once the products are installed.

JDK component

The JDK contains the software and tools that developers need to compile, debug, and run applets and applications written using the Java programming language. The JDK software and documentation, typically included with each new release of an operating system, are available for download at the vendor’s Web site. You need a JDK if you intend to develop Java stored procedures and triggers with the database, or to create Java proxies with the Progress® Open Client Toolkit.

Note: For details about the Release 10.1A supported platforms and specific Java requirements needed to support an OpenEdge installation on each platform, see the "Supported platforms and Java components" section.

Ensuring that the correct Java version is installed and recognized

The following conditions must exist to ensure that correct Java version is properly installed on your machine and it is accurately recognized by the OpenEdge installation:

Install the certified JDK to be used with OpenEdge Release 10.1A before you install OpenEdge.
Ensure that the JDK is located in the $PATH environment variable to ensure that the OpenEdge installation can tailor the java_env file.
The $PATH environment variable must point to the correct Java installation before you run the proinst utility. Otherwise, the system’s default Java executable’s version will be referenced from the PATH; the system’s default is not necessarily the correct Java version for the OpenEdge installation.
Ensure that the JDK is located in $JAVAHOME/bin environment variable so that the Installation Utility can find it. (The JAVAHOME PATH is the Java installation directory.)

If the correct Java software is not supplied with your installation medium, you must ensure that it is correctly installed on your system, according to the previously criteria.

OpenEdge Products that required the JRE

The JRE consists of the Java Virtual Machine, the Java Core Classes, and supporting files. The JRE is the run time part of the JDK and does not include a compiler, a debugger, or development tools. You need the JRE if you intend to use one of the following:

Progress Explorer.
WebSpeed Transaction Server.
OpenEdge Application Server Basic.
OpenEdge Application Server Enterprise.
Java application or applet.
OpenEdge® Adapter for SonicMQ®.
Web Services Adapter.
Secure AppServer Internet Adapter (AIA).

You will also need the JRE to execute Java stored procedures and triggers from the database.

JDK and specific OpenEdge platforms

The JDK ships with OpenEdge Release 10.1A products that run on the either the Solaris SPARC 32- or 64-bit platforms.

JRE and specific OpenEdge platforms

The JRE ships with OpenEdge Release 10.1A products that run on the following platforms:

HP Tru64
HP-UX (PA-RISC) (32-bit)
HP-UX64 (PA-RISC) (64-bit)
HP-UX (ITANIUM)
Solaris SPARC (32-bit)
Solaris SPARC (64-bit)
Note: If you are using the 32-bit JRE on a 64-bit machine, Java triggers and stored procedures are not supported.

Supported platforms and Java components

As mentioned earlier in this chapter, on the supported Sun Solaris platforms, the OpenEdge installation program also automatically installs the JDK when you install a product that requires the JDK.

On other supported platforms, as described in the following list, you might need to install some required Java components:

HP-UX — The installation program does not automatically install the JDK component if you install OpenEdge on this platform. If you want access to the JDK and do not already have it installed, you should install the required version of the JDK on your target system. For more information on Java requirements, see Table 2–1.

Additionally, it might be necessary for you to adjust the default kernel parameter max_thread_proc. To determine whether the default kernel parameter is too low and should be modified, contact your system administrator.

HP Tru64, AIX, and Linux platforms — The installation program does not automatically install the JRE or JDK component if you install an OpenEdge component on one of these platforms. You must install the required version of the JRE and/or the JDK (if not already installed) on your target system. For more information on Java requirements, see Table 2–1.
OpenEdge SQL — The installation program does not automatically install the JDK component when you install the OpenEdg RDBMS Enterprise Edition, the OpenEdge RDBMS Personal Edition, or the OpenEdge RDBMS Workgroup Edition with the OpenEdge SQL Client Access. If you intend to develop Java stored procedures and Java triggers for your database, you must install an OpenEdge development product. For information on writing Java stored procedures and triggers, see OpenEdge Data Management: SQL Development .

Operating systems and JDK and JRE version details

Table 2–1 lists operating systems and specifies the versions of JDK and JRE each supports.

Table 2–1: JRE/JDK requirements by platform

Platform	JDK/JRE required	JDK location
Solaris SPARC (32-bit and 64-bit)	1.4.2.06 (JDK and JRE shipped with OpenEdge)	http://java.sun.com
HP-UX (PA-RISC) (32-bit and 64-bit)	1.4.2.06 (JRE ships with OpenEdge Release 10.1A)	http://www.hp.com/java
HP-UX ITANIUM	1.4.2.06	http://www.hp.com/java
Tru64 UNIX 5.1B(64 bit)	1.4.1.06	http://www.hp.com/java
RedHat Enterprise Linux 2.1	1.4.1_06 (Sun)	http://www.java.sun.com
SuSE Linux Enterprise Server 8	1.4.1_06 (Sun)	http://www.java.sun.com
TurboLinux Enterprise Server 8	1.4.1_06 (Sun)	http://www.java.sun.com
IBM AIX 5.2 (32-bit and 64-bit)	JVM 1.4.1_06	http://www.ibm.com/java
UnixWare 7.1.4	JVM 1.4.203	http://www.sco.com/unixwa re

To determine what version of Java you currently have on your operating system, type java -version at the command line.

Note: On some platforms, multiple versions of Java may be available.

You can change your PATH variable to reference a different version, if needed. In the case of the Open Client Toolkit, other Java versions (including versions from other vendors) can also be used.

When SUN provides a JDK and JRE for a certain platform, Progress Software Corporation (PSC) includes the JDK and JRE in its distribution. For other systems, you must obtain the JDK from the system’s operating system vendor. Contact your operating system vendor for assistance in obtaining the JDK.